Transfer Mode Structure (IM: XO)

Inside Macintosh: QuickDraw GX Objects /

Chapter 5 - Ink Objects / Ink Objects Reference

Transfer Mode Structure
The transfer mode structure (data type gxTransferMode) specifies the transfer mode property of an ink object.
struct gxTransferMode{
   gxColorSpace               space;      
   gxColorSet                 set;
   gxColorProfile             profile;
   Fixed                      sourceMatrix[5][4];
   Fixed                      deviceMatrix[5][4];
   Fixed                      resultMatrix[5][4];
   gxTransferFlag             flags;
   struct gxTransferComponent component[4];
};
Field Description

space
The color space used by this transfer mode. The color spaces defined by QuickDraw GX are listed in the color structure definition shown in the previous section, and are described in the chapter "Colors and Color-Related Objects" in this book. A transfer mode's color space need not be the same as the color space of the ink object the transfer mode is part of.
set
A reference to a color set, an object that defines a list of colors available for use by this transfer mode. This field has meaning only if the transfer mode's color space is gxIndexedSpace; if the value in this field is nil, there is no color set associated with the transfer mode. Color sets are described in the chapter "Colors and Color-Related Objects" in this book.
profile
A reference to a color profile, an object that specifies color-correction information. If the value in this field is nil, there is no color profile associated with the color space of this transfer mode. Color profiles are described in the chapter "Colors and Color-Related Objects" in this book.
sourceMatrix
A 5 x 4 matrix that specifies how to transform the source color before applying the component modes to the components. See "Transfer Mode Matrices" beginning on page 5-33.
deviceMatrix
A 5 x 4 matrix that specifies how to transform the destination color before applying the component modes to the components. See "Transfer Mode Matrices" beginning on page 5-33.
resultMatrix
A 5 x 4 matrix that specifies how to transform the result color after applying the component modes to all components. See "Transfer Mode Matrices" beginning on page 5-33.
flags
The transfer mode flags; they specify how to handle color limits and whether multiple transfer components are needed. The transfer mode flags are described in the section "Transfer Mode Flags" on page 5-35.
component
An array of four transfer component structures, each specifying the type of transfer mode to apply to a single color component of the transfer mode's color space. The transfer component structure is described next.